Basic Configuration
This page outlines the basic configuration settings for DreamFactory. For the most part, this entails adding or updating parameters in the .env file located in the dreamfactory
directory. Common tasks and procedures are outlined below, and each parameter is individually documented in the Configuration Parameters section of this page.
For web server configurations, check the child pages of this section for your specific web server.
Common configuration tasks and FAQs
Changing configuration
Any time configurations are changed in the .env file, at a minimum, the confguration cache must be cleared. This is done by running php artisan config:clear
in the dreamfactory
directory.
Enable debugging
Two parameters are used for this process:
APP_LOG_LEVEL
: Set todebug
for debug mode. Other levels are described in the parameter listing below.APP_DEBUG
: Set totrue
to turn on application debug messages. This triggers DreamFactory to return a payload with a trace for error(s).
Changing the system database
This requires updating the connection to your database type (mysql, sqlsrv, pgsql, sqlite) and providing the necessary connection details.
DB_CONNECTION
: Type of database connection.DB_HOST
: Database host address.DB_PORT
: Database port number.DB_DATABASE
: Database name.DB_USERNAME
: Database username.DB_PASSWORD
: Database password.
Caching settings
To update the default cache (file) to an external cache (Memcache or Redis), or to a local alternative (apc, array, database, file) you can update the following values.
CACHE_DRIVER
: Cache driver type.CACHE_DEFAULT_TTL
: Default cache TTL in seconds.CACHE_PREFIX
: Prefix for cache keys.CACHE_PATH
: Cache path for 'file' driver.CACHE_TABLE
: Cache table for 'database' driver.CACHE_HOST
,CACHE_PORT
,CACHE_PASSWORD
,CACHE_WEIGHT
,CACHE_PERSISTENT_ID
,CACHE_USERNAME
,CACHE_DATABASE
: Cache settings for 'memcached' or 'redis'.
Configuration parameters
Below, the .env in its entirety is outlined and every parameter described. These parameters are listed in the order/section they would normally exist on a DreamFactory instance.
Application settings
ASSET_URL
: Configures the asset URL host.VIEW_COMPILED_PATH
: Location for compiled Blade templates.BCRYPT_ROUNDS
: Options for Bcrypt password hashing.APP_NAME
: Name of the application.APP_CIPHER
: Encryption cipher options.APP_DEBUG
: Debugging trace toggle in exceptions.APP_ENV
: Environment type (local, production).APP_KEY
: Application encryption key.APP_LOCALE
: Default application locale.LOG_CHANNEL
: Configuration for log channels.APP_LOG_LEVEL
: Log level setting.APP_LOG_MAX_FILES
: Max log files for 'daily' logging.APP_TIMEZONE
: Timezone setting for PHP functions.APP_URL
: External URL for the installation.DF_LANDING_PAGE
: Default landing page URL.
Database settings
DB_CONNECTION
: Type of database connection.DB_HOST
: Database host address.DB_PORT
: Database port number.DB_DATABASE
: Database name.DB_USERNAME
: Database username.DB_PASSWORD
: Database password.DB_CHARSET
: Database character set.DB_COLLATION
: Database collation setting.DB_QUERY_LOG_ENABLED
: Toggle for database query logging.DB_MAX_RECORDS_RETURNED
: Max records returned in queries.DF_SQLITE_STORAGE
: Location for SQLite3 database files.DF_FREETDS_SQLSRV
,DF_FREETDS_SQLANYWHERE
,DF_FREETDS_SYBASE
,DF_FREETDS_DUMP
,DF_FREETDS_DUMPCONFIG
: FreeTDS configuration settings.
Cache settings
CACHE_DRIVER
: Cache driver type.CACHE_DEFAULT_TTL
: Default cache TTL in seconds.CACHE_PREFIX
: Prefix for cache keys.CACHE_PATH
: Cache path for 'file' driver.CACHE_TABLE
: Cache table for 'database' driver.CACHE_HOST
,CACHE_PORT
,CACHE_PASSWORD
,CACHE_WEIGHT
,CACHE_PERSISTENT_ID
,CACHE_USERNAME
,CACHE_DATABASE
: Cache settings for 'memcached' or 'redis'.
Limit cache settings
LIMIT_CACHE_DRIVER
: Limit cache driver type.LIMIT_CACHE_PREFIX
: Prefix for limit cache keys.LIMIT_CACHE_PATH
: Path for 'file' limit cache.LIMIT_CACHE_TABLE
: Table for 'database' limit cache.LIMIT_CACHE_HOST
,LIMIT_CACHE_PORT
,LIMIT_CACHE_PASSWORD
,LIMIT_CACHE_WEIGHT
,LIMIT_CACHE_PERSISTENT_ID
,LIMIT_CACHE_USERNAME
,LIMIT_CACHE_DATABASE
: Limit cache settings for 'memcached' or 'redis'.
Queuing settings
QUEUE_CONNECTION
: Queue connection type.QUEUE_NAME
: Name of the queue.QUEUE_RETRY_AFTER
: Retry time for failed jobs.QUEUE_TABLE
: Queue table for 'database' driver.AWS_ACCESS_KEY_ID
,AWS_SECRET_ACCESS_KEY
,AWS_DEFAULT_REGION
,SQS_PREFIX
: AWS SQS settings.QUEUE_HOST
,QUEUE_PORT
,QUEUE_DATABASE
,QUEUE_PASSWORD
: Queue settings for 'beanstalkd' or 'redis'.
Event broadcasting settings
BROADCAST_DRIVER
: Broadcasting driver type.PUSHER_APP_ID
,PUSHER_APP_KEY
,PUSHER_APP_SECRET
: Pusher settings.BROADCAST_HOST
,BROADCAST_PORT
,BROADCAST_DATABASE
,BROADCAST_PASSWORD
: Broadcast settings for 'redis'.
DreamFactory settings
DF_LOGIN_ATTRIBUTE
: User authentication attribute.DF_ENABLE_ALTERNATE_AUTH
: Toggle for alternate authentication.DF_ENABLE_WINDOWS_AUTH
: Windows authentication for AD SSO.DF_CONFIRM_CODE_LENGTH
: Length of user confirmation code.DF_CONFIRM_CODE_TTL
: TTL for confirmation code.JWT_SECRET
: JWT encryption secret.DF_JWT_TTL
,DF_JWT_REFRESH_TTL
,DF_ALLOW_FOREVER_SESSIONS
: JWT session settings.DF_JWT_USER_CLAIM
: Custom JWT claim fields.DF_CONFIRM_RESET_URL
,DF_CONFIRM_INVITE_URL
,DF_CONFIRM_REGISTER_URL
: URLs for user actions.
Storage settings
DF_FILE_CHUNK_SIZE
: Chunk size for downloadable files.
Scripting settings
DF_SCRIPTING_DISABLE
: Disables specific scripting languages.DF_NODEJS_PATH
: Path to Node.js executable.DF_PYTHON_PATH
: Path to Python executable.DF_PYTHON3_PATH
: Path to Python3 executable.DF_SCRIPTING_DEFAULT_PROTOCOL
: Default protocol for scripting calls.DF_SCRIPT_INLINE_CHAR_LIMIT
: Inline script character limit.
API settings
DF_API_ROUTE_PREFIX
: Prefix for API routes.DF_STATUS_ROUTE_PREFIX
: Prefix for status routes.DF_STORAGE_ROUTE_PREFIX
: Prefix for storage routes.DF_XML_ROOT
: Root tag for XML responses.DF_ALWAYS_WRAP_RESOURCES
,DF_RESOURCE_WRAPPER
: Resource wrapping settings.DF_CONTENT_TYPE
: Default response content-type.DF_LOOKUP_MODIFIERS
: Allowed lookup modifiers.DF_PACKAGE_PATH
: Path for package import at launch.DF_INSTALL
: Installation source.
Managed settings
DF_MANAGED
: Managed environment toggle.DF_MANAGED_LOG_PATH
,DF_MANAGED_CACHE_PATH
,DF_MANAGED_LOG_ROTATE_COUNT
,DF_MANAGED_LOG_FILE_NAME
,DF_LIMITS_CACHE_STORE
,DF_LIMITS_CACHE_PATH
: Managed environment settings.SENDMAIL_DEFAULT_COMMAND
: Default sendmail command.DF_REGISTER_CONTACT
: Registration contact information.
LogsDB settings
LOGSDB_ENABLED
: LogsDB enabled toggle.LOGSDB_HOST
,LOGSDB_PORT
,LOGSDB_DATABASE
,LOGSDB_USERNAME
,LOGSDB_PASSWORD
: LogsDB settings.
License key
DF_LICENSE_KEY
: DreamFactory license key.